home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / news / NewsUpdate21.lha / NewsUpdate / NewsUpdate.doc < prev    next >
Text File  |  1995-04-22  |  7KB  |  211 lines
  1.  
  2.           NewsUpdate 2.1, © 1994 to 1995 by Kevin J. Phair.
  3.  
  4.                          FREELY DISTRIBUTABLE
  5.  
  6.  
  7. About NewsUpdate
  8.  
  9.     NewsUpdate is an updated version  of  my  (previously  unreleased)
  10.     program,  NextUpdate.  I  know  there's  already  a program called
  11.     NextUpdate,  but  that  wasn't  it  (although  it  did   something
  12.     similar.)
  13.  
  14.     What my version did was  to  also  strip  out  unnecessary  header
  15.     information  from  articles,  since the newsgroups were being made
  16.     accessible through the BBS. Stripping out  the  information  means
  17.     that  there  is  less clutter at the top of a news article if it's
  18.     being read online, or if you get it via FIDONet.
  19.  
  20. Special Features
  21.  
  22.     So, here's version 2.1, with a new name (NewsUpdate, in case  that
  23.     wasn't clear), and the ability to specify names/part-names to look
  24.     for in the From: header, to see if the message should  be  killed.
  25.     So  now you can remove bandwidth-wasting posters from your message
  26.     base, and even people like myself who use  GRn  will  benefit,  if
  27.     only in terms of reduced blood pressure.
  28.  
  29.     At some stage, I would hope to add support for killing articles by
  30.     subject, and perhaps other things too.
  31.  
  32.     NewsUpdate has been tested with Enforcer and has produced no hits.
  33.  
  34. Using NewsUpdate
  35.  
  36.     Usage is pretty simple, the first argument must be a filename, and
  37.     it  must  be  the filename of your active newsgroups file (the one
  38.     you use for NNTPxfer), and then you can follow that up  with  some
  39.     options.
  40.  
  41. Memory requirements:
  42.  
  43.     If you have T: assign to somewhere in RAM:, then you  should  make
  44.     sure  that  you  have  enough RAM to cope with the largest article
  45.     that will be processed, or assign T: elsewhere.
  46.  
  47.     The command template is as follows:
  48.  
  49.     NewsUpdate Active-file [QUIET] [NOISY] [KILL] [CLEAN] [COLOUR] [NOBIN]
  50.  
  51.     Keywords are not case-sensitive.
  52.  
  53. What's an 'active' file?
  54.  
  55.     The active file is the newsgroup control file that your are  using
  56.     with  NNTPxfer  (or similar) to transfer news articles. The format
  57.     should typically be along the lines of this:
  58.  
  59.     rec.arts.sf.tv.babylon5 36785 36605 n
  60.     ieie.announce 330 22 n
  61.     ieie.comments 936 181 n
  62.     ieie.help 713 297 n
  63.     ieie.test 349 164 n
  64.     comp.sys.amiga.hardware 14798 14721 n
  65.     comp.sys.amiga.programmer 8723 8693 n
  66.     comp.sys.sinclair 3452 3433 n
  67.     alt.sex.wizards 5619 5603 n
  68.     alt.tv.x-files 29140 29090 n
  69.     alt.tv.melrose-place 7114 7103 n
  70.  
  71.     I.e. lines of "Newsgroup high-pointer low-pointer flag"
  72.  
  73.     You MUST provide an active newsgroup list or this program can't do
  74.     anything for you.
  75.  
  76.  
  77. Command line options
  78.  
  79. QUIET
  80.  
  81.     Will prevent any normal output from cluttering your CLI window  or
  82.     accidentally opening one up from your script.
  83.  
  84.  
  85. NOISY
  86.  
  87.     Will provide more detailed information  on  what  the  program  is
  88.     doing  (i.e.  it will list articles as it cleans them, and also as
  89.     it kills them, if necessary)
  90.  
  91.  
  92. KILL
  93.  
  94.     Will make the program read in a list of specifiers from  the  file
  95.     'UULib:KillFile.From'  when  it  starts  up,  and as it scans each
  96.     article, it will see if any of these specifiers are  contained  in
  97.     the  From:  header.  If  there  is  a  match,  then the article is
  98.     deleted. NOTICE that this only needs to find the string WITHIN the
  99.     From:  line, so you can specify a source address to search for, or
  100.     even a partial address, e.g.:
  101.  
  102.     'anewton@alturia' would match posts by user 'anewton'  at  machine
  103.     'alturia',  in any domain. '@loser.com' would match posts from any
  104.     user at loser.com. 'Robodude@'  would  match  posts  from  a  user
  105.     called "Robodude" posting from any site.
  106.  
  107.     '(Kevin Phair)' would match any of my posts, whether it's me using
  108.     my own account, or posting from the BBS.
  109.  
  110.     You can get a bit  of  added  safety,  by  putting  in  the  whole
  111.     address, and even including the "From: " at the start of the line!
  112.  
  113.     This is a very powerful option, and you should be as  specific  as
  114.     possible  in  terms  of origin addresses you want to kill articles
  115.     from.
  116.  
  117.  
  118. CLEAN
  119.  
  120.     This is one of the reasons the program was first written (since an
  121.     ARexx  script  can  quite happily look after updating those little
  122.     .next files anyway!)
  123.  
  124.     What it does is it buffers each article through a  temporary  file
  125.     in  T:,  and  keeps only the From:, Organi[s|z]ation:, Message-ID,
  126.     References:, Subject: and Date: fields.  Everything  else  in  the
  127.     message header is discarded. Once the header has been parsed, then
  128.     the body of the article is pushed straight through, and  then  the
  129.     original article is overwritten with the new, leaner article.
  130.  
  131.     The reason I leave the threading fields in is that I,  or  someone
  132.     else,  may decide at some stage to convert these to FIDO threading
  133.     kludges.
  134.  
  135.  
  136. NOBIN
  137.  
  138.     Will skip any newsgroups with 'binaries'  in  the  name,  so  that
  139.     large  numbers  of  large  files  will  not be thrashed to-and-fro
  140.     betweenthe hard disk and RAM, as there is little point  in  making
  141.     large encoded posts a few lines shorter.
  142.  
  143.     Note: Using NOBIN will still update the .next pointer!
  144.  
  145.  
  146. COLOUR (or COLOR)
  147.  
  148.     Will enable ANSI colour codes (limits itself to the first four)
  149.  
  150.  
  151. Return codes:
  152.  
  153.     The program will return an error code  of  30  if  there  are  any
  154.     errors, and a return code of 0 if all has gone well.
  155.  
  156.  
  157. Example usage:
  158.  
  159.     NewsUpdate UULib:News/Active KILL NOISY COLOUR
  160.  
  161.         Will scan articles, using killfile to remove  unwanted  posts,
  162.         and  will  provide a running commentary on what it's doing, as
  163.         well as putting colour in the output, so you can see things  a
  164.         bit more clearly.
  165.  
  166.     NewsUpdate UULib:News/Active QUIET CLEAN NOBIN
  167.  
  168.         Standard usage for SysOps; No output, trim article headers,
  169.         don't process articles in any binary newsgroups.
  170.  
  171.  
  172. Future:
  173.  
  174.     Anyone interested in an option to ARCHIVE posts by certain people,
  175.     or subjects, into a separate directory, or even run a user-defined
  176.     command on the articles?
  177.  
  178.     I think I'll probably  release  the  source  code  with  the  next
  179.     version.
  180.  
  181. History:
  182.  
  183. Version 1 has been in use for the last 6  or  7  months  with  no  ill
  184. effects,  hopefully  this version will be just as reliable.
  185.  
  186. Version 2.0: Pretty much the same as this version (2.1) but with no
  187.              colour.
  188.  
  189. Version 2.1: Fixed bug where it wouldn't update newsgroup with only
  190.              one new article.
  191.  
  192.  
  193. Author information:
  194.  
  195. I've written other stuff, mainly for DLG BBS SysOps:
  196.  
  197.     DLGFM. Small program to manage simple file area maintenance (i.e.
  198.     remove orphaned .fd files, rebuild quick file description
  199.     table...)
  200.  
  201.     DLG-Edit. Slightly larger program, which provides a GUI interface
  202.     for editing User records, File/Message areas (names, access
  203.     levels, import text files to create new areas...)
  204.  
  205.     Vec (not yet released). Small WB toy which sits in a window
  206.     displaying shaded rotating 3D polygon-based shapes.
  207.  
  208. If you find bugs, or have suggestions, then e-mail me at Kev@Scorpio.ie,
  209. or you can send fido netmail to me at 2:263/150.6
  210.  
  211.